home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat4 / dwarf.z / dwarf
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  61 lines
  1. DWARF(4)                                              Last changed: 4-12-99
  2.  
  3.  
  4. NNAAMMEE
  5.      ddwwaarrff - DWARF version 2 debugging information format
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ddwwaarrff..hh>>
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      IRIX systems
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      ddwwaarrff is a format for the information generated by compilers,
  15.      assemblers, and linkage editors that is necessary for source-level
  16.      debugging.  It allows a compact representation of programs in many
  17.      languages and is easily extended to handle additional languages and
  18.      individual compiler/debugger requirements.
  19.  
  20.      ddwwaarrff itself does not specify how to generate or use the information.
  21.      Instead, it defines the 'bits on the disc.'  See the lliibbddwwaarrff(4) man
  22.      page for information on reading and writing DWARF information.
  23.  
  24.      This format was designed by a multi-company committee called the
  25.      PLSIG, working under the auspices of Unix International.  The format
  26.      is based on the SVR4 debugging information format, (which might be
  27.      called version 0) and a codification of that format developed by the
  28.      committee (which was called version 1).  Version 2 was designed by the
  29.      committee to reduce the disk space used and to add descriptive power
  30.      (as compared to versions 0 and 1).  The Version 2.0.0 Industry Review
  31.      Draft was made available July, 1993.
  32.  
  33.      For details of the format see the document _D_W_A_R_F _D_e_b_u_g_g_i_n_g _I_n_f_o_r_m_a_t_i_o_n
  34.      _F_o_r_m_a_t, which is the file _d_w_a_r_f._v_2._m_m in the IIDDOO//ddeevv option subsystem,
  35.      ccoommppiilleerr__ddeevv..oopptt..ddwwaarrff.  The iinnddeexx..vv22..mmmm file is an index to that
  36.      document.  The ..ppss files are PostScript versions of the same files.
  37.  
  38.      The DWARF debugging information is present only in programs compiled
  39.      with --nn3322 or --6644.  This information is put, as needed, into sections
  40.      of an ELF object file named ..ddeebbuugg__iinnffoo, ..ddeebbuugg__ffrraammee, ..ddeebbuugg__lliinnee,
  41.      ..ddeebbuugg__aarraannggeess, ..ddeebbuugg__lloocc, ..ddeebbuugg__ffrraammee, ..ddeebbuugg__ssttrr, ..ddeebbuugg__aabbbbrreevv,
  42.      ..ddeebbuugg__ppuubbnnaammeess, ..ddeebbuugg__wweeaakknnaammeess, ..ddeebbuugg__ffuunnccnnaammeess, ..ddeebbuugg__ttyyppeennaammeess,
  43.      and ..ddeebbuugg__vvaarrnnaammeess.
  44.  
  45.      With programs compiled with --oo3322, the compiler puts debugging
  46.      information into the ..mmddeebbuugg section of the ELF file (the section
  47.      format is identical to the IRIX 4 COFF symbol table.
  48.  
  49. FFIILLEESS
  50.      //uussrr//sshhaarree//ssrrcc//ccoommppiilleerr//ddwwaarrff//ddwwaarrff..vv22..mmmm
  51.      //uussrr//sshhaarree//ssrrcc//ccoommppiilleerr//ddwwaarrff//ddwwaarrff..vv22..ppss
  52.      //uussrr//sshhaarree//ssrrcc//ccoommppiilleerr//ddwwaarrff//iinnddeexx..vv22..mmmm
  53.      //uussrr//sshhaarree//ssrrcc//ccoommppiilleerr//ddwwaarrff//iinnddeexx..vv22..ppss
  54.  
  55. SSEEEE AALLSSOO
  56.      ddwwaarrffdduummpp(1)
  57.  
  58.      lliibbddwwaarrff(4)
  59.  
  60.      This man page is available only online.
  61.